docs: README pre-release lifts (numbers, hypergeometric, scope, security, research) - #75

• Adds reproducible benchmark table with operating points from synthetic corpus
• Surfaces Bitmap prefilter's hypergeometric null as principled statistical test
• Introduces Security section on index-file trust and format validation
• Adds Research collaboration section with named co-authorship invitation
• Clarifies scope as composable library layer under ANN/sharding systems
• Documents RankQuantFastscan and MultiBucketBitmap with stability caveats
• Notes in-progress Python bindings and PyPI release pending
• Refines MSRV 1.89 rationale with precise intrinsic and API requirements

Comprehensive README documentation enhancements and clarifications

• Reframes scope as composable library layer under ANN/sharding systems
• Adds 5-row operating-point benchmark table with caveats (synthetic corpus, specific hardware,
 deterministic R@10)
• Introduces hypergeometric null section explaining Bitmap prefilter as principled statistical test
• Documents RankQuantFastscan and MultiBucketBitmap with stability/experimental caveats
• Adds Python bindings section noting in-progress PyPI release
• Introduces Security section on index-file trust and format validation
• Adds Research collaboration section with explicit named co-authorship invitation
• Expands Documentation section with ALTERNATIVES_CONSIDERED and INDEX_PROVENANCE links
• Refines MSRV 1.89 rationale with precise intrinsic and API requirements

README.md

CHANGELOG entry for README documentation updates

• Adds Documentation section under Unreleased documenting all README pre-release lifts
• Summarizes benchmark table, hypergeometric null, security callout, research collaboration, scope,
 API stability notes, Python bindings, and MSRV rationale

CHANGELOG.md

Description

README links to docs/ALTERNATIVES_CONSIDERED.md, but Cargo.toml excludes that file from the
crate package, so consumers installing from crates.io won’t have that referenced document available.
This creates a broken/undiscoverable documentation path at release time.

Code

README.md[R125-126]

Evidence

The README adds a relative link to docs/ALTERNATIVES_CONSIDERED.md, but Cargo.toml explicitly
excludes that same file from the packaged crate contents, making the referenced doc unavailable to
crate consumers.

README.md[123-129]
Cargo.toml[14-23]

Agent prompt

The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

### Issue description
`README.md` links to `docs/ALTERNATIVES_CONSIDERED.md`, but that file is excluded from the crate package via `[package].exclude`. This means users reading the README from the published crate (or viewing crate sources) won’t be able to follow the link.

### Issue Context
The file exists in the repo, so the link works on GitHub, but it is intentionally excluded from the published crate payload.

### Fix Focus Areas
- README.md[121-129]
- Cargo.toml[14-23]

### Fix options (pick one)
1. **Preferable:** Change the README link to an **absolute GitHub URL** (so it works for both GitHub and crates.io readers).
2. Or **ship the doc** by removing `docs/ALTERNATIVES_CONSIDERED.md` from `[package].exclude` (if you want it included in the published crate).
3. Or remove the README bullet if you intentionally don’t want to expose it to crate consumers.

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools